home *** CD-ROM | disk | FTP | other *** search
/ Aminet 4 / Aminet 4 - November 1994.iso / aminet / comm / ums / kms190b.lha / KMS / Doc / KMSXPR.doc < prev    next >
Text File  |  1994-09-10  |  9KB  |  214 lines
  1.  
  2.  
  3.  
  4.        KMSXPR 1.02 -*- KMS File Transfer Server ©1993 Thomas Schwarz
  5.        =============================================================
  6.  
  7.  
  8.  
  9.                                 Documentation
  10.                                 =============
  11.  
  12.  
  13.  
  14. Description:
  15. ------------
  16.  
  17. KMSXPR  is  responsible  for  all Xpr-Library filetransfers done by KMS, my
  18. famous  "Karfunkel  Mailbox System". It is designed especially for use with
  19. KMS and is not intended to be used by anything or anybody else. (But surely
  20. I'm not able to stop you from abusing it anyway :-)
  21.  
  22. Input and output is completely handled through the standard io-channels, so
  23. these have to be properly redirected for working on a serial line. But this
  24. is  very  well  handled  by KMS, so you don't have to bother about it. (You
  25. really don't have to bother about anything referring to KMSXPR if you don't
  26. misuse  it  as  already  mentioned  before  :-)  (So  why  do you read this
  27. documentation at all? :-)
  28.  
  29.  
  30.  
  31. Call Syntax: (CLI only)
  32. ------------
  33.  
  34. KMSXPR LIBRARY/A,OPTIONS/K,RECEIVE/S,SEND/S,LOGDIR/K,DEFDIR/K,LIST/K,FILES/M
  35.  
  36.  
  37.  
  38. Parameters:
  39. -----------
  40.  
  41. LIBRARY/A     Required: name of xpr-library to use for the file transfer
  42.               (e.g. "xprzmodem.library")
  43. OPTIONS/K     Optional: xpr-library options (see docs for used library)
  44.               (e.g. OPTIONS="TN ON B16 F0 E10 AN DN KY SN RN PT:")
  45. RECEIVE/S     Optional: start transfer in receive mode (default)
  46. SEND/S        Optional: start transfer in send mode
  47. LOGDIR/K      Optional: directory for transfer logging (defaults to "T:")
  48.               (e.g. LOGDIR = DH0:Logs)
  49.               The format of an entry in the logfile is as follows:
  50.               "Filename Filesize Characters-per-Second Sent/Rcvd Libraryname"
  51. DEFDIR/K      Optional: directory for received files (default is current dir)
  52.               (e.g. DEFDIR = Downloads:)
  53. LIST/K        Optional: file which contains, line by line, the names of
  54.                         the files to be transfered including full path
  55. FILES/M       Optional for receiving, required for sending, if no LIST given:
  56.               Receiving: name of the file to be received. If none is given,
  57.                          the name is tried to be taken from the sending side
  58.               Sending  : name(s) of the file(s) to be sent
  59.  
  60.  
  61.  
  62. Distribution:
  63. -------------
  64.  
  65. The "Karfunkel Mailbox System" and "KMSXPR" are
  66. Copyright ©1993/94 by Thomas Schwarz.
  67. All Rights Reserved.
  68.  
  69. "KMSXPR" is only to be distributed as part of the KMS package. Really ONLY.
  70. Please refer to the KMS documentation for further distribution information.
  71.  
  72.  
  73.  
  74. Author information:
  75. -------------------
  76.  
  77. It's me :-)
  78.  
  79. Thomas Schwarz
  80. Gieshügeler Straße 26
  81. 97218 Gerbrunn
  82. Germany
  83.  
  84. Email: kmshq@bmagic.mayn.sub.de
  85.        Thomas_Schwarz@wue.maus.de
  86.  
  87.  
  88. Acknowledgements:
  89. -----------------
  90.  
  91. This program is heavily based on "XPR" from the AXsh-Package  by  the  well
  92. known   genius   Pasi   'Albert'   Ojala   (Internet:  albert@cs.tut.fi  OR
  93. albert@cc.tut.fi). If you don't already know about AXsh, please  read  this
  94. excerpt from the original AXsh documentation (you'll like it! :-)
  95.  
  96. ---------------------------------------------------------------------------
  97.  
  98. AXsh  is  a  shell  based local communication software, which allows remote
  99. users  to connect to your machine. AXsh can also be run under UUCP, but you
  100. need  to  do some changes to some of the configuration files. AXsh consists
  101. of  three  main  parts:  the  AXsh shell software, AX-sysghost, which holds
  102. information  about  users and AX-server, which takes incoming calls, starts
  103. AXsh  etc.  AXsh supports multiple users, multiple lines and different user
  104. levels.  You  can  define  allowed  commands  and directories for each user
  105. level.  Command  arguments  can  also be restricted to home directory or to
  106. allowed directories.
  107.  
  108. AXsh  is  a SHAREWARE product and the REGISTRATION fee is about US$ 30, 150
  109. FIM.  We'll  accept any other currency too, because that is more convinient
  110. for  everybody, but US$ and FIM are preferred. The cheapest way to send the
  111. money  is  in  cash in a letter. If you don't plan to register, but have an
  112. Internet  mail  address,  you should still send some mail so I can keep you
  113. upto  date  about  updates  to the demo distribution. We are developing the
  114. system  constantly  and all comments and bug reports are welcomed. (See the
  115. addresses in the end of this document.)
  116.  
  117. ---------------------------------------------------------------------------
  118.  
  119.  
  120.  
  121. Copyright notices:
  122. ------------------
  123.  
  124. Unix is a registered trademark of AT&T
  125.  
  126. Amiga is a registered trademark of Commodore Business Machines, Inc.
  127.  
  128. AmigaOS is a registered trademark of Commodore Business Machines, Inc.
  129.  
  130. AXsh, KMS and KMSXPR are not registered trademarks, but using them without
  131. permission is bad for your teeth.
  132.  
  133.  
  134.  
  135. Disclaimer:
  136. -----------
  137.  
  138.                           *** STANDARD DISCLAIMER ***
  139.  
  140.    This product is meant for educational purposes only.  Any  resemblance
  141.    to real persons, living or dead is  purely  coincidental.  Void  where
  142.    prohibited. Some assembly required. List each check separately by bank
  143.    number. Batteries not included. Contents may settle  during  shipment.
  144.    Use only as directed. No other warranty expressed or implied.  Do  not
  145.    use while operating a motor vehicle or heavy equipment.  Postage  will
  146.    be paid by addressee. Subject to CAB approval. This is not an offer to
  147.    sell securities. Apply only to affected area. May be too  intense  for
  148.    some viewers. Do not stamp. Use other side  for  additional  listings.
  149.    For recreational use only. Do not disturb. All models over 18 years of
  150.    age.   If   condition   persists,   consult   your    physician.    No
  151.    user-serviceable parts  inside.  Freshest  if  eaten  before  date  on
  152.    carton. Subject to change without notice. Times approximate. Simulated
  153.    picture. No postage necessary if mailed in the United States. Breaking
  154.    seal constitutes acceptance of agreement. For off-road  use  only.  As
  155.    seen on TV. One size fits all. Many suitcases look alike.  Contains  a
  156.    substantial amount of non-tobacco ingredients. Colors  may,  in  time,
  157.    fade. We have sent the forms which seem to be right for you.  Slippery
  158.    when wet. For office use only. Not affiliated with  the  American  Red
  159.    Cross. Drop in any mailbox. Edited for television. Keep cool;  process
  160.    promptly. Post office will  not  deliver  without  postage.  List  was
  161.    current at time of printing. Return to sender, no forwarding order  on
  162.    file,  unable  to  forward.  Not  responsible  for  direct,  indirect,
  163.    incidental or consequential damages resulting from any  defect,  error
  164.    or failure to  perform.  At  participating  locations  only.  Not  the
  165.    Beatles. Penalty for private use. See label for sequence.  Substantial
  166.    penalty for early withdrawal. Do not write below  this  line.  Falling
  167.    rock. Lost ticket pays maximum rate.  Your  cancelled  check  is  your
  168.    receipt. Add  toner.  Place  stamp  here.  Avoid  contact  with  skin.
  169.    Sanitized for your protection. Be sure each item is properly endorsed.
  170.    Sign here  without  admitting  guilt.  Slightly  higher  west  of  the
  171.    Mississippi. Employees and their families are not eligible. Beware  of
  172.    dog. Contestants have been briefed on some questions before the  show.
  173.    Limited time offer, call now to insure prompt delivery.  You  must  be
  174.    present to win. No passes accepted for this  engagement.  No  purchase
  175.    necessary. Processed at location stamped in code  at  top  of  carton.
  176.    Shading within a garment may occur. Use only in well-ventilated  area.
  177.    Keep away from fire or flame. Replace with  same  type.  Approved  for
  178.    veterans. Booths for two or more. Check here if tax  deductible.  Some
  179.    equipment shown is optional. Price does not include taxes. No Canadian
  180.    coins. Not recommended for children. Prerecorded for this  time  zone.
  181.    Reproduction strictly prohibited. No solicitors. No alcohol, dogs,  or
  182.    horses. No anchovies unless otherwise specified.  Restaurant  package,
  183.    not for resale. List at least two alternate dates. First pull up, then
  184.    pull down. Call toll free before digging. Driver does not carry  cash.
  185.    Some  of  the  trademarks  mentioned  in  this  product   appear   for
  186.    identification purposes only. Record additional transactions  on  back
  187.    of previous stub. Decision of judges is final.
  188.  
  189.    This supersedes all previous notices.
  190.  
  191.  
  192.  
  193. Conclusion:
  194. -----------
  195.  
  196.    ...and always remember: The answer still is 42.
  197.  
  198.  
  199.  
  200. Quote of the day:
  201. -----------------
  202.  
  203.   "You mean mysterious ancient races of Amazonian princesses who subject all
  204.   male prisoners to strange and exhausting progenitative rites?"  said Eric,
  205.                          his glasses beginning to fog.
  206.                               -- (Terry Pratchett, Eric)
  207.  
  208. Last words:
  209. -----------
  210.  
  211. Perhaps you wonder why this documentation is written in English while KMS
  212. in general is a German system? Well, I'm practising my English :-)
  213.  
  214.